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DOMLMR maintains an Object Module Library (OML) , on a 

IV tr.°r, 7 ?/ 590 dlSC Unit > in a format acceptable to 
R S A 1 L J nkage Editor (LNKEDT) utility. DOMLMR will 

without t !' np a L T PlaC ? individual or groups of modules 
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Because of a difference in format between a disc OML 

*f f Lih ™y Transcriber Routine (CLTR) and 

DOMLMR, this utility will not maintain the master OML. 
Any attempt to update the master OML with DOMLMR will 
result in an error message and program termination. 

Spectra 70 Processor 
One tape station 
One disc drive 

One printer (if PRINT option is used) 
Approximately 17,000 
Spectra Assembly 

^ e to m diic.° f reqUlred t0 read 3 tape and tra ^ribe 
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A source program deck is available. 



DQQB0D 

Computer Users 



TABLE OF CONTENTS 

SUBJECT 
Description 
Equipment 
Memory Required 
Source Language 
Input Data Format 
Output Data Format 
Timing 

Operating Procedure 

Initialization 

Extent Change 

General 
Stop Conditions (messages) 
Programmer Instructions for Use 



APPENDIX A Input Record to Output Reco d Conversion 

General 

Object Module Directory Block (00) 1 6 

Index Block (01)«je 

Object Module Descriptor Block (02) 

EXTRN Block (03) 16 

Text Block (04) 16 

Modifier Block (05)^ 

APPENDIX B DOMLMR Control Record 

Format 

Format Example 

Disc address translation Example 
APPENDIX C COMLMR Logic Charts 



TABLE OF CONTENTS 



MAINTENANCE SECTION 



SUBJECT 



NARRATIVE 
PAGE 



MAINTENANCE DOCUMENTATION FOR DOMLMR 
PREOML PROGRAM NARRATIVE 

Mainline Logic Documentation: 



2-3 



LOGIC 
CHART 
PAGE 



Housekeeping Section 

Object Module Directory Block 

Index Block (01) 

Object Module Descriptor (02) 

Extrn Block Processing (03) 

Text Block (04) and 

Modifier Block (05) 
End of Job Processing 

Sub Processing Notes: 



(00) 



BAL TO 
TAG: 



2-9 
2-11 

2-15 
2-15 

2-15 
2-15 



c* 1 

C "° 

o 9 
c-ii 

C-12 
C-13 

c-14 



Move Logic 
Write Logic 



Calculate Next Avail. CCHHR from 
Table 

Reset Used Bit in Table Based on , 

CCHHR Address 
Read Logic For Record Type 00 

t! II II II II QJ^ 

Used to Rewrite Updated 00 Record 

II If II II Qj^ II 

Locate Module Nmae in 00 Record 



Locate 01 Record Based on 00 Pointer 
Chase 01 Records For 01 Transaction 
Shift 00 Record To Delete Entry 
Module Name Print Routine 



MOVE 
WRITE 1 
CLEAR 
CLEAROT 

TTOA 

ATOT 

RE ADO 

READ1 

WRITE0 

WRITE01 

DL00 

DL00D 

CHASE01 

CHASE02 

SHIFT00 

PRINTO 



2-5 
2-5 



2-6 

2-6 
2-6 
2-6 
2-7 
2-7 
2-7 
2-7 
2-7 
2-8 
2-8 
2-8 



c-15 
c-16 



C-17 

C-19 

C-20 
C-20 
C-20 

C-21 

C-22 
c "22 
C-23 



Disc Object Module Library Maintenance Routine 
(DOMLMR) 



Description: DOMLMR maintains an Object Module Library (OML), 

on a 70/564 or 70/590 disc unit, in a format 
acceptable to the RCA Linkage Editor (LNKEDT) 
utility. DOMLMR will add, delete, and replace 
individual or groups of modules without the 
need to replace the entire disc resident library. 
Because of a difference in format between a 
disc OML created by the Call Library Trans- 
criber Routine (CLTR) and DOMLMR, this utility 
will not maintain the master OML. Any attempt 
to update the master OML with DOMLMR will re- 
sult in an error message and program termina- 
tion. 

The disc area used by DOMLMR must begin at 
cylinder 1, track zero, and may extend thru 
cylinder 200 on a 70/564 or 70/590. The mini- 
mum allocation is two cylinders. After alloca- 
tion of the disc area with the RCA utility 
Random Access Storage Allocator (RAALLR) , the 
area is preformatted by the PREOML program 
provided with this package. The allocated 
disc area may be increased at any time by 
running RAALLR, followed by PREOML. 

* 

The input to DOMLMR is an OML - the output 
from the Object Module Library Update routine 
(OMLU) . Three standard OMLU control cards may 
be used to convert an Object Module File (OMF) 
from a language translator (SYSUT1) to an OML. 
These three control cards will convert a single 
or multiple module SYSUT1. 
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Deletion of modules from the disc OML is 
accomplished via a console message. The 
program will request the names of modules to 
delete when it is run outside of monitor. 
Up to an 80 character message is accepted from 
the console which consists of variable length 
(1 to 8 characters) module names separated by 
commas. In addition to module names, two 
special meaning operands may be entered: 

$ST0P - If this operand is used, it must 

be the last entry. This operand 
specifies no input tape. When it 
is recognized in the parameter 
string, the program goes to normal 
termina tion. 

$PRINT- This operand causes a listing of 

the names of all the modules con- 
tained in the OML. 

When existing modules are deleted from the OML, 
all the records used by that module are released 
for subsequent use. For this reason, no file 
re-organization is required. When a later 
version of a module is transcribed to the OML, 
the module is technically deleted from the 
file and then re-entered as an addition. This 
allows the size of the module to change with- 
out regard for the original area occupied. 

DOMLMR will not properly catalog a module con- 
taining a sort due to the fact that OMLU does 
not convert all of the required information 
contained on SYSUT1. If an attempt is made 
to convert and catalog a module containing a 
sort, OMLU will reflect the omitted informa- 
tion in on. error listing, produce an OMF and 
DOMLMR will catalog OMLU's output without warn- 
ing. Such a cataloged module will not link 
properly and should be deleted from the disc 
OML. 

Backup for an OML maintained by DOMLMR is 
provided by the RCA utility Disc Dump and Re- 
load (DDRL) . Once a module is cataloged into 
the OML, there is no way to retrieve it 



1-2 



except via LNKEDT. There is no facility to 
extract any particular module from the file 
for subsequent storage on tape or punched 
cards. 

DOMLMR and PREOML contain a constant which 
reflects the volume serial number of the disc 
containing the OML. For this reason, no run 
time parameters are required for proper device 
assignment. The only program change required 
is setting these values which are at a tag 
! NAME3. 1 

The user must bear in mind that subsequent 
software releases may render certain cata- 
loged modules unusable due to changes to the 
language translators that modify generated 
coding. The main area of concern is code 
generated for FCP and by COBOL for the f CALL 1 
and ' RETURN 1 verbs. As changes of this type 
are seldom, they do not pose a serious pro- 
blem for DOMLMR users. 

The storage capacity is: 

70/590 - 4 records per track - 

1688 bytes per records 
70/564 - 3 records per track - 

1129 bytes per record 

Cylinder one tracks zero thru eight contain 
the Object Module Directory - one 16 byte 
entry for each module contained in the library: 

70/590 - 105 entries per record 

3778 entries maximum (note 1) 

70/564 - 70 entries per record 

1888 entries maximum (notes 1 and 2) 

Cylinder one, track nine, contains the DOMLMR 
control record. 

Cylinder one, tracks eleven thru nineteen, 
for 70/590 are not used. 

Cylinder two thru the last cylinder in the 
extent contain the data records or actual modu- 
les. Each module will require at least two 
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Equipment: 



Memory 
Required : 



of these records for storage. The data records 
are fixed length of 1688 or 1129 bytes to 
facilitate update writes to the disc; however, 
the data contained in them is variable length. 



Note 1 



Note 2 



Two of the entries in this 
area are control entries, 
the first one and the last 
one. 

The 70/564 does not use the 
last byte of the 1129 byte 
directory record. 



The PREOML and DOMLMR routines are programmed 
for both 70/590 and 70/564 support. The 
device used is determined by the assignment 
made. No program changes are required. 

If DOMLMR terminates abnormally, it cannot 
be run again until the disc extent has been 
re-established by DDRL. Access is still 
possible by LNKEDT. 

One tape station for input (SYSUT2) . 

One disc drive with the 'Object Module Lib 1 

extent. 

One printer if the $PRINT option is used in 
reply to the 'MODULES TO DELETE ? f message. 



Approximately 17,000 bytes. 



Input Data 
Format: 



The input to DOMLMR is an OML formatted as 
described in the TOS Utilities Manual 70-35-302 
Parameter cards are not required for this pro- 
gram. The names of modules to delete from the 
disc OML are accepted from the console when 
the utility is run outside of monitor. The 
'Operating Procedures' section of this narra- 
tive describes the format and options for 
the console request. 
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The output of DOMLMR is described in appendix 
A of this narrative. Appendix A also corrolates 
the input fields that are used with the output 
format on disc. 

The amount of time required to read the tape 
and transcribe it to disc. 



1. Allocate disc area for a file named 
'OBJECT MODULE LIB 1 . This area must begin 
on cylinder one, track zero, and consist 
of at least two full cylinders. Only full 
cylinder allocation is acceptable to the 
DOMLMR system. The extent must consist 

of contiguous cylinders. 

2. Change the volume serial number in the DC 
entry called ! NAME3 1 of both the DOMLMR 
and PREOML programs to reflect the volume 
serial numbers allocated in Step 1. 

3. Assemble and run the PREOML program. The 
1 STOP CONDITIONS 1 portion of this narra- 
tive explains the typeouts produced. No 
parameters are required. 

4. Assemble and transcribe the DOMLMR program 
to the master 1 PGMLIB 1 on the executive 
disc-. The system is now ready for use. 



From time to time it may be necessary to 
increase the size of the extent allocated as 
the OML. This can be accomplished by running 
RAALLR to de-allocate (not purge) the extent 
and then to re-establish it. Following the 
RAALLR run, PREOML must be run to update the 
control record to reflect the change prior to 
running DOMLMR. The 1 STOP CONDITIONS' portion 
of this narrative explains the typeouts pro- 
duced by PREOML. It is recommended that DDRL 
be run to provide a tape backup for the extent 
immediately after PREOML has been run. 

DOMLMR may be run as part of a monitor job 
stream or independently under the TDOS execu- 
tive. Device assignment is automatic for 
the required disc device. 

INPUT: An Object Module File (OMF) which is 

SYSUT2 out of the OMLU utility. This 
assignment is optional - see 'MODULES 
TO DELETE ? ! message. 



OUTPUT: Disc resident OMF. 

Printer (SYSLST) - optional - See 
'MODULES TO DELETE ?' message. 

PARAMETERS: No punched card parameters - see 

"MODULES TO DELETE ? 1 message for 
console parameter format and options. 
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Programmer Considerations for Use of the Disc Object Module Library 

Maintenance Routine (DOMLMR) 



The DOMLMR program accepts an Object Module Library (OML) tape as 
input and transcribes every module on the tape to disc. The output 
of a program translator (SYSUT1) is an Object Module File (OMF) . To 
convert an OMF to an OML for use with DOMLMR, it is necessary to 
run the Object Module Library Update (OMLU) routine. The input to 
OMLU is a SYSUT1 tape, the output is SYSUT2. The following example 
shows where the OMLU control cards go within a translator job 
stream. The parameters shown convert all the modules on SYSUT1 
to an OML for subsequent transcription to disc by DOMLMR. 

Once a module is transcribed to disc, it will remain there until 
it is deleted via a console message. The program will not request 
modules for deletion when run under monitor. 

When a given module is processed through DOMLMR, the module direc- 
tory on disc is searched to see if the module already exists. If 
it does, it is replaced by the new version. If it does not exist, 
it is added to the file. ,The only restriction to the use of the 
DOMLMR is that MODULES CONTAINING A SORT MAY BE TRANSCRIBED TO 
DISC, BUT THE LINKAGE EDITOR WILL NOT BE ABLE TO LINK THEM BACK. 
If you do put a sort module out to the library, inform operations 
so that they may delete it to free up the disc space. 

// STARTM 
// JOB 
// PA RAM 

// translator (ASSMBL, COBOL, FORTRN, RPG) 

SOURCE DECK (MODA) 
// translator 

SOURCE DECK (MODB) 

// EXEC OMLU 
COPY NONE 
CATALO SYSUT1 
END 

// EXEC DOMLMR 
// LNKEDT 
PROG MODAB 

INCLUDE SYSOML (MODA , MODB ) 
// ENDMON 
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MODA and MODB will be cataloged as separate modules. If MODA 
or MODB or both must be re- trans la ted at a later date, the 1 // 
EXEC OMLU f thru '// ENDMON f control cards remain the same. For 
example, if MODB required re- translation, it would be transcribed 
to disc, following OMLU, and then linked with the original version 
of MODA. 
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MAINTENANCE DOCUMENTATION FOR DOMLMR 



The logic used to reformat a given record type (00-05) 

on the input tape OML for the disc resident OML was 

determined by manual R/A edit comparison after CLTR to a 

tape edit of the input OML. The reformat logic as determined 

by this process is explained in appendix A. The same method 

is quite reliable for determining a problem which may be 

uncovered in DOMLMR today. As of the time this document 

is being written, DOMLMR is maintaining over 200 modules on 

a 70/590 without a problem. 

» 

I recommend that prior to any change to DOMLMR, you thoroughly 

* 

familiarize yourself with this program via the documentation 
provided. A brief description of each of the sub processing 
logic modules used is provided along with a detail logic chart. 
Appendix A and B should also be reviewed prior to going 
through the main line code of the detail logic charts. 

The GETEM macro, which prints out at the front of the assembly 
listing, is used for random access device assignment to elim- 
inate the need for run time parameters. The function of this 
macro is to build an extent matrix for the VSN and file name 
indicated at, in this case, tag NAME3. 



The only program change required to implement this utility- 
is the VSN number located at tag NAME3 . The program is 
preset for 70/564 use and modifies itself for 70/590 use if 
that is the device assigned. 

The main line code of the program has notes indicated on the 
logic chart by double circles which are keyed to the notes 
themselves. The Sub Processing Notes section is keyed to 
sections by name and a more explanatory logic chart has been 
drawn. The Sub Processing Notes are designed for handy reference 
during your analysis of the main line code to explain the action 
taken by the ! BAL ! blocks. 
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PREOML PROGRAM NARRATIVE 



The PREOML utility is used to preformat the disc extent used with 
the DOMLMR program. This utility will preformat a 70/590 or 
70/564 disc. The GETEM macro is used for device assignment. 
The volume serial number of the volume to be initialized is at 
tag NAME 3 card number 02990. The following operations are per- 
formed by this program: 

1. Verify that the extent starts on cyl 1 track zero and 

is allocated in full cylinder increments. If the program 
is being run to extend an existing area, the new ending 
cylinder number must be greater than the old ending 
cylinder number. 

2. Write 1688 or 1129 byte records of all hex zero to every 
track in the extent (4 records of 1688 bytes per track 

for 70/590 or 3 records of 1129 bytes per track for 70/564). 

3. The first record of the Directory is formatted as indicated 
in appendix A. All records in the Directory are chained 
together by position 1-5. The records in cyl 2 through 

n are not chained. 

4. The control record is constructed and written to track 
nine cylinder one. The cylinders that are a llocated are 
set to hex zero in the track table of the control record. 



The portion of the track table representing area be- 
yond the allocated area is set to hex 1 77 1 for 70/564 
or hex f FF ! for 70/590 to indicate full. 
5. When PREOML is run to extend an existing extent, the 
newly acquired area is pref ormatted with dummy records 
and the control record is updated to reflect the new 
extent limits . 
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SUB PROCESSING NOTES 

SECTION NAME: MOVE LOGIC ENTRY POINT: MOVE 

FUNCTION: This logic will move the number of bytes specified 

by the half word constant following the BAL instruc- 
tion from the address contained in GR 4 to the address 
contained in GR 5. If the field to be moved is larger 
than the remaining bytes in the output area (GR 6) , 
the field moved is split to fill up the current output 
block, that block is written to disc, and the r ema i_nd er 
of the field is moved to the start of the next block. 
After the move is complete, GR 4 and GR 5 are incremented 
by the number of bytes moved. 

SECTION NAME: WRITE LOGIC ENTRY POINT: WRITE 1 

C LEAR. 
CLEAROT 

FUNCTION: This logic will write the block contained in OTARA to 

disc. It uses the Table To Address (TTOA) logic to 

determine the 'write to f address on disc. The address 

(CCHHR) of the next logical record is placed in 

position 1-5 of the current output record unless the 

switch at tag OTSW is turned on. When the record is 

written, GR 6 is set to indicate a full block and GR 5 

is set to OTARAH-8 in preparation for the next move. The 

2-5 



first disc 'write to 1 address is generated by the TTOA 
logic called in the 01 processing for initialization. 
This routine is entered at tag CLEAR in the house- 
keeping logic and tag CLEAROT in the 01 logic. 



SECTION NAME: CALCULATE NEXT AVAILABLE ENTRY POINT: TTOA 

CCHHR FROM TABLE 

FUNCTION: This logic generates a CCHHR address for disc based 

on the next available address in the track table por- 
tion of the control record. The generated CCHHR 
address is placed at tag DCCHH. If the extent is ex- 
hausted, it is detected in this logic. The number of 
remaining data records counter in the control record 
is decreased by 1. 



SECTION NAME: RESET USED BIT IN TABLE ENTRY POINT: ATOT 

BASED ON CCHHR ADDRESS 

FUNCTION: This logic sets the bit in the track table to off 

that corresponds to the CCHHR address at tag 'DCCHH'. 

The number of remaining data records counter in the 

Ft 

control record is increased by 1. 



SECTION NAME: READ LOGIC FOR RECORD TYPE 00 ENTRY POINT: READO 

READ LOGIC FOR RECORD TYPE 01 ENTRY POINT: READ1 

FUNCTION: The disc record specified by CCHHR in tag SEKADR+3 is 

accessed in OTARAOO for a 00 record or OTARA for a 01 
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record. The address of the record just accessed 
(CCHHR) is stored for subsequent use by the REWRITE 
logic for 00 and 01 records. The CCHHR address in 
tag SEKADR+3 must be provided prior to entering the 
READ logic. 



00 RECORD 

USED TO REWRITE UPDATED ENTRY POINT: WRITE01 

01 RECORD 

FUNCTION: The record currently in core at tag OTARAOO for the 00 

record or OTARA for 01 record is written to disc at 
the address stored by a previous read (READO or READ1) . 



FUNCTION: The 8 byte module name at tag DELPRG is located in 



the directory. If the module name is not in the 
directory, the address returned points to the next 
sequential directory entry. The address of the left 
end of the directory entry in OTARA00 is returned in 
GR 1. A direct branch to tag DL00D is used in the 
print logic along with setting the switch at tag 
'PONLY' for the serial access of the directory. 



SECTION NAME: USED TO REWRITE UPDATED 



ENTRY POINT: WRITE0 



SECTION NAME: LOCATE MODULE NAME IN 00 

RECORD 



ENTRY POINT: DL00 

DL00D 



SECTION NAME: LOCATE 01 RECORD BASED 

ON 00 POINTER 



ENTRY POINT: CHASE01 



FUNCTION: The CCHHR address of the 01 record for the 00 record 

indicated by GR 1 is accessed into tag OTARA. GR 1 
is set to the CCHHR address in the 01 record which 
points to the first data record for the module. (See 
appendix A). This module is designed to be used 
following the DL00 logic. 

SECTION NAME: CHASE DATA RECORDS FROM ENTRY POINT: CHASE02 

01 TRANSACTION 

FUNCTION: Reset the corresponding bit in the track table to OFF 

for the 01 record just accessed and read and reset 

all corresponding bits for all 02 through 05 data 

» 

blocks for the module. The last block for module 
will contain hex zero in pos 1 through 5. 

SECTION NAME: SHIFT 00 RECORD TO DELETE ENTRY POINT: SHIFT00 

ENTRY 

This logic shifts the 00 record at tag OTARA00 16 
positions left to eliminate an entry. GR 1 must point 
to the left end of the module to be deleted (set up by 
DL00 logic) / 

SECTION NAME: MODULE NAME PRINT ROUTINE ENTRY POINT: PRINTO 

FUNCTION: This logic prints a listing of all the module names 

contained in the directory. It is used in the deletion 

logic as a result of the t PRINT operand. 
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NOTES FOR MAIN PATH LOGIC 



Note Chart HOUSEKEEPING SECTION 

Number 

1 c ~l The CLEAR logic is located in the WRITE logic 

section. The OTARAOO and OTARA are cleared to 
hex zero. The return address from the CLEAR 
logic is a preset initial value of HSKP+5 at 
tag ST14 which is loaded into GR14 at the end of 
the WRITE logic. 

2 Ol This is done to prevent problems in the end of 

job logic in the event of a null input tape. 

3 C-l All reads and writes to disc will BAL 14 to tag 

RTRY in the event of an I/O error. This tag is 
located in the GETEM macro. The GETEM macro main- 
tains a count of the number of re-tries and types 
a message if the count is exhausted. 

4 c-l The f R f in the word f DOMLMR ! located in the control 

record (see appendix B) is used for a file lock/ 
unlock 'indicator . If the program terminates ab- 
normally, the file will be locked. This prevents 
DOMLMR from changing data in the file until the 
maintenance programmer can analyze the problem. 
The indicator is reset by re-establishing the file 
with DDRL. 

5 Ol Control record verification is made by a compare 

of the constant 1 DOMLMR 1 to the first six positions 
of the control record read. See appendix B for 
'the format of the control record. 

6 C-l If the ending CCHH in the extent matrix does not 

match the CCHH in the control record, the program 
terminates. Probably caused by the size of the 
extent being extended by RAALR and not running 
PREOML to update the control record and preformat 
the new area prior to running DOMLMR. 

7 C-l The ! R f in the word 'DOMLMR 1 is reset at this point. 

When the control record is written back to disc at 
normal end of job, it will unlock the file. 
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The date in the executive is compared to the date 
in the first record in the Directory. See Directory 
Record format in appendix A. 

Because the module names entered via the console 
can be variable length, they must be expanded to 
eight positions prior to searching for them in 
the Directory. 

The comparison of tag DELPRG to the address in 
GR 1 indicates if the module was found in the 
directory or not. (See DL00 logic.) 

The letters 1 CCHHR 1 are placed in the Directory 
record in place of an actual disc address until 
the 'Ol 1 (Index Record) is read from the input 
tape and on actual disc address is calculated 
for the 01. This compare was mainly used for 
debugging . 

Setting DELPRG to hex zero causes the DL00 logic 
to access the first directory block and point to 
the first directory record following the dummy 
record (see appendix A). 

Setting the NOP switch in the DL00 logic causes 
serial access of every record of every block in the 
directory. 

PRINTO, the logic module that formats and prints 
the directory listing, uses logical level FCP. 
For this reason, the address generated by the DL00 
logic in GR 1 must be shifted to GR 5 to be saved. 

The high dummy Directory entry (see appendix A) 
signals end of job to the print "logic module 
(PRINTO) and breaks the print loop. 

Tag DL00D is located in the DL00 logic module. 
Because the DL00 logic was last entered by a BAL 14 
(just prior to tag PLISTB) it will continue to re- 
turn to that tag until it is reset by a BAL 14 
from another location. 
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The DTFSR for the input tape is set for unlabeled 
tape. The 3 EXCPW macros rewind the tape and 
position it in front of the first tape mark for the 
open macro. The DTFSR is also set for no rewind 
at open. 

The first data record following the tape mark on 
a tape OML is a special identifying record. 

OBJECT MODULE DIRECTORY BLOCK (00) PROCESSING 

General registers 5, 6 and 7 are loaded from tag 
REC00. GR 5 contains the starting address of 
0TARA0O+8 in the REC00 area. This value is used 
as the ! T0 f address in the MOVE logic. After a 
move, GR 5 is incremented by the length of the 
move to set up for the next move. GR 6 contains 
the number of bytes that will fit in the current 
record. This register is decremented by the num- 
ber of bytes moved. GR 7 points to tag REC00. 
This is used to access reset values for the first 
two entries (GR 5 and 6) and to access the storage 
area for the CCHHR of the 00 record currently in 
core. (See READ0 and WRITE0 logic.) 

The MOVE, logic will automatically write a record 
when the I/O area is full as determined by the 
remaining byte count in GR 6. This logic is not 
desirable for the 00 record processing. By loading 
GR 6 with the value of 2000, this feature is not 
used. 

The NOP at tag MEX0 is set to go to tag EM0. 

The 00 record contains multiple module names and 
is fixed length. The unused portion of the tape 
record following the last module name is filled 
with hex zero. In the event that the 00 record 
is full, GR 10 is loaded with the address of the 
last input record position plus 1. As GR 4 is 
moved from one module to the next, it is compared 
to GR 10 for equality. 

This switch is turned on at A page 7 wh en a 
new module is to be added to the file. When the 
switch is 'on 1 , the 00 record is rewritten to disc. 
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This switch is turned on when an entry was shifted 
out of the block to make room for an addition. 
(See tag OF00 page 7.) 

Go read the 01 record in the data position of the 
extent into OTARA. 

Go access all records for the module in the data 
position of the file and set the bits in the track 
table to not vised. 

This block saves the current address of the module 
being processed in the tape input area. It then 
sets the 'TO 1 address for the move logic (GR 5) 
to the end of the 0TARA00 area +1 and the 1 FROM 1 
address for the move logic to the last 16 byte 
entry in in the OTAROO (70th entry for 564, or 
105th entry for 590) . 

The BAL to 'MOVE 1 at tag MAGN moves 16 bytes and 
increments GR 4 and GR 5 the length of the move. 

The switch at MEX0 is turned on when the last move 
is about to be made. The normal ON for this switch 
goes to tag EMO. The switch is altered to go to 
tag OF00B at tag ONFR on page 8. This setting is 
used if more than one directory block has to be 
accessed and shifted to make room for a module 
entry. 

GR 1 contains the address in the OTARA00 block of 
where the new module should be merged. A compare 
of GR 4 (from address of move) to GR 1 for equality 
determines the last module is about to be moved 
and sets the switch at MEX0 to break the loop. If 
GR 4 valve is less than GR 1, the error branch tag 
TERMDA is taken. 

If the error condition at note 29 is sensed, it is 
not an error if the module to be added belongs in 
the last position of the record. 

Record shifted out is determined by a compare of 
hex zero to the end of 0TARA00+1. If the area 
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contains hex zero, no record has been shifted out. 
If a record has been shifted out, it is put in the 
first entry of the next 00 block. 

GR 1 is set to the address of OTARA00+8. This 
causes the logic at tag SHIFT00 to move every 
entry in the 00 record 16 bytes right to free up 
the first entry for the entry shifted out the end 
of the previous record. 
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INDEX BLOCK (01) PROCESSING 



If multiple 01 blocks are read for a single 
module, they all contain the same indicators 
for the number of entries, externs and common 
as well as the same constant info. For that 
reason, this branch goes directly to the logic 
to move the ! N ! fields contained in the second 
and following records. (See appendix A-4) 

This is the first call in the program for an 
address generation from the table. The TTOA 
logic generates the CCHHR of the first available 
disc address at tag DCCHH. The WRITE logic 
keeps track of the next available disc address 
to put in bytes 1 thru 5 of the current record 
by issueing all subsequent calls for logic 
module TTOA. 

The area OTARA is cleared to hex zero initially 
at this point. The WRITE logic clears this 
area after each WRITE. 

INDEX BLOCK 01 PROCESSING 



The 'move 1 logic will write the 01 record to 
disc if the output area is full. In this case 
pos 1-5 of the first 01 record will contain the 
CCHHR of the next 01 record. 

See the Utilities Manual for definition of SUB 
CODE in position 2 of the input tape for a 01 typ 
record . 

Since 01, records are written under control of 
the WRITE logic used with the MOVE logic, the 
CCHHR of the next record is placed in pos 1-5 of 
the record. Control is transferred to this 
block when the last 01 record for the module 
has been constructed. Since this is the last 
data record for this module until the 02 record 
is later accessed from tape, it is so indicated 
by the hex zero in pos 1-5. Setting the switch 
in the WRITE logic inhibits the moves of CCHHR 
to overlay the hex zero. 
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Note Chart 
Number 



OBJECT MODULE DESCRIPTOR BLOCK (02) 



39 



oil 



Note Chart 
Number 



The 02 records on tape represent the first 
record of a new module. The first 02 accessed 
will follow the last 01 record on tape and will 
cause the switch at tag D02 to be turned off. 
When the switch is off and an 02 record is read 
from tape, the last record for the previous 
module is written to disc with positions 1-5 
of that record set to hex zero as an end of 
module indicator. The number of used bytes in 
the record is also calculated and put into the 
record. 

EXTRN BLOCK PROCESSING (03) 



40 



Ol2 



Note Chart 
Number 



41 



c-13 



This move takes all the extrns in one move to 
the output record. GR 4 and 5 are set to the 
correct addresses by the previous move. The 
number, of bytes to move is calculated in the 
logic at tag D03B. 

TEXT BLOCK (04) AND MODIFIER BLOCK (05) PROCESSING 



When the address of tag LEN04 is sent to the move 
logic in Gr 4, the move logic will check to insure 
that there is at least 10 bytes remaining in the 
output area prior to the move. If less then 10 
bytes remain, the current record is written to 
disc and the data In tag LEN04 is put at the 
front of the next record. This is done to 
insure that fields A thru D are not split over 
two records . 



Note Chart 
Number 



END OF JOB PROCESSING 



42 



o 14 



Since the WRITE logic maintains the CCHHR of the 
next available disc address, it must be reset 
to unused at end of job. The table entry was 
initially set to used when the CCHHR was generated 
in the ATOT logic. 
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APPENDIX A 

Input Record To Output Record Conversion 

See TOS Utilities Manual 70-35-302 (Object Module Library) for a 
description of the input tape. 

To illustrate the conversion from tape Object Module Library (OML) 
format to disc OML format, charts have been inter sperced with the 
narrative. The space between each dot represents two bytes. The 
tape and disc positions indicated are zero relative. A field with 
no tape position indicated in the 'From Tape 1 line indicates infor- 
mation generated by the program. A layout with no 'To Disc 1 line 
indicates that the particular record type can be located anywhere 
within the data bytes alloted in each disc record. The first 8 
positions reflect the five position CCHHR address of the next logi- 
cal record for the module, followed by a three position hexidecimal 
count field of the number of data bytes that are used. 

The basic processing is as follows: 

Record type (00)^5 (Descriptor Block) - fixed length of 
16 bytes on disc. 

Each 16 byte entry is merged into a sequential location in 
one c£ the records located in cylinder 1 track 0 thru 8. 
Record type (01) -^5 (Index Block) - starts a new record 
in the data portion of the file (note 1). 

Record type (02) (Descriptor Block) - starts a new record 
in the data portion of the file (note 1) and is immediately 
followed on the output record by the next input transaction 
(03) 16 , (04) 16 or (05) 16 . 

Note 1 ; The data portion of the file is cylinder two track zero 

to end of extent for 70/590 and 70/564. This is the area 
covered by the track table contained in the DOMLMR 
control record. Cylinder one tracks zero thru eight 
contains the Object Module Directory, cylinder one 
tr a ck nine is the DOMLMR control record. Cylinder one 
tracks eleven thru twenty are not used on the 70/590. 

Record 

Size: 70/590 is 1688 byte records - 4 per track - 1680 data 

portion. 

70/564 is 1129 byte records - 3 per track - 1121 data 
portion. 
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Object Module Directory Block (00)]^ 

Disc Record Layout 
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9 1 
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To 

DISC 


0 k 


5 7 


8 1 
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6 0_ 
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i 2. 


Size 
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Field Contents 

A. CCHHR of next Object Module Directory Block (next sequential 
record in cylinder one) . 

B. Three position byte count for this block - represents the sum 
of the 16 byte entries only. This field is calculated in the 
Object Module Directory Block Logic (00) 16< 

Fixed length entries of 16 bytes - one per module. 

C. Eight position module name. 

D. CCHHR of the corresponding Index Block in the data portion 
of the field. (established when the Index Block - (01) ]_g is 
read from tape.) 

E. Three position displacement of the Index Block within the 
record specified in field 'D'. (zero in all cases because 
each Index Block starts a new record) 

Genera 1 : 

1. The total record length is 1129 bytes (16 byte entries X 70 
entries per record ) + 8 control characters + 1 unused byte 
at the end of the record) for 70/564. For the 70/590 the 
total record length is 1688 bytes (16 byte entries X 105 
entries per record) + 8 control characters. 

2. DOMLMR uses tracks 0 thru 8 of cylinder 1 to contain the 
Object Module Directory. 
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3. Entries do not overflow records. 

4. The first entry of the first record contains - 'OMLU 22 
10 YYJJJ 1 where YYJJJ is the year and julian date of the 
last reference to the file by DOMLMR. 

" 5. The last entry of the Directory contains a module name of 

lozenges, a CCHHR of ' CCHHR 1 and a displacement of hex zero 
except for 2? of the high order position. 
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Index Block (01) 
Disc Record Layout 



Field Contents 

A. CCHHR of first detail record for this module. Same as field 
'E ! . Established when the (02) 16 record is read from tape. 

B. Byte count for this block - represents size of data portion 
only. 

C. Byte count for the record. 

D. Module name. 

E. CCHHR of first detail record for this module. (Same as field 
'A 1 ) Established when (02) 16 record is read from tape. 

F. Displacement of data in the record located at the CCHHR 
address indicated in field f E ! . (zero in all cases because 
each Object Module descriptor Block (02) 16 starts a new 
record) . 

G. Unused - pad with zero. 

H. Module length. 

I. Extern name. 

J. Starting address. 
K. DDNAME (for include) 
L. OMNAME (for include) 
M. Unused - set to zero. 

N. First 12 byte entry name (8 bytes) and starting address 
(4 bytes). This field is repeated for each entry, extern 
and/or common for this module. 

General: 

1. Each Index Block begins a new record. 
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The Index Block is variable length as determined by number 
of entries, externs and common. (total entries, externs, 
and common X 12 Bytes per entry + 50). 

The address of the Index Block record is determined by the 
table search logic in the TTOA logic. 
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Object Module Descriptor Block (02) ^ 

Disc Record Layout 
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Field Contents 

A. CCHHR of next record for this module or hex zero if this is 
the last record for the module. 

B. Block length - initially set to the maximum data bytes to 
reflect a full record in the (02) processing. Reset to 
adjusted length when the next (02) ^5 is read or the end of 
the input tape is read' in the End of Job Logic. 

C. Record length - f 000E' for (02) 16 record. 

D. Block Code (02) 16 

E. Type of block that follows (See Utilities Manual for code 
explanation. ) 

F . Hax^e-^ Q - r o 0 e r v^-— #e^~ f u-bu-r-e~-u-s-e . 

G. Module name. 
Genera 1 : 

1. Each Object module Description Block begins on a new record. 
It will be immediately followed by one of the other record 
types (03 16 -05 16 ). 

2. The CCHHR address of this record is contained in the corres- 
ponding Index Block (01) ^5 fields A and E. 
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EXTRN Block (03) 16 
Disc Record Layout 
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Field Contents 

A. Length of (03) ^5 record - starting in tape relative position 
12 is a variable number of 11 byte EXTRN S . This length is 
computed in the 03 logic by multiplying the number of these 
11 byte entries by 11 and adding 6 additional bytes for the 
fixed length portion of the disc record. 

B. Block Code - (03) 16 

C. Block Subcode (See Utility Manual for code explanation) 

m 

D. Filler - not used. 

E . EXTRN 

F. Type Code 

G. ESID 
General 

1. Fields E, F and G represent one EXTRN. These fields are 
repeated for each EXTRN. 

2. The EXTRN block may be located anywhere in the data portion 
of a disc record and may overflow records. 
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Text Block 
Disc Record 



(04) 16 
La yout 
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Size 
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Field Contents 

A. Length of (04) record - this size is calculated by adding 6 
bytes to the 'Block Byte Count 1 field positions 2 and 3 of the 

(04) - r record . 
lb 

B. Block code (04)]_g 

C. Block Subcode (See U tilities M.anual for code explanation.) 

D. Load address of next block. 

E. Text - variable size - up to 1044 bytes. 
General 

1. The move logic will insure that fields A, B and C will fit on 
the end of the current output record when field T A ! is moved. 

To accomplish this the current output record must have 10 or more 
bytes remaining prior to the 'A 1 field move. If it does not 
have sufficient room, the length of the current output record 
(OTARA + 6 and 7) is modified, the record is written to disc 
and the ! A f field is placed in the next record starting in 
OTARA + 8. 

2. The 04 record may reside anywhere in the data portion of a 
disc record and may overflow records. 
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Modifier Block (05) 
Disc Record Layout 
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up to 117 char. 



Field Contents 

A. Length of (05) record - this size is calculated by sub- 
tracting 4 from the length of the tape record read. 

B. Block Code (05) 

C. Block Subcode (See Utilities Manual for code explanation.) 

D. Load address of next block. 

E. Modifier count. 

F. Modifiers - 10 bytes each. The length of this variable 
portion of the record is calculated by subtracting 12 from 
the length of the input record. (See Utilities Manual for 
contents of modifier record.) 

General 

1. The 05 record may reside anywhere in the data portion of 
disc record and may overflow records. 

2. Fields A thru E may not be split; the balance of the input 
record may be. 
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APPENDIX B 
CONTROL RECORD FORMAT 



THIS RECORD IS CONTAINED ON CYLINDER 1, TRACK 9, RECORD 1 



FIELD POSITION SIZE DESCRIPTION 

1 0-5 6 RECORD IDENTIFIER (DOMLMR) 

2 6-9 4 CCHH OF LAST TRACK IN EXTENT 

3 10-12 3 5% OF ORIGINAL NUMBER OF RECORDS 

AVAILABLE. PROGRAM WILL TYPE WARNING 
MESSAGE WHEN FIELD 5 BECOMES EQUAL 
TO OR LESS THAN THIS AMOUNT. (PACKED) 

4 13-16 4 NOT USED - FOR RAEDIT ALIGNMENT ONLY. 

5 17-19 3 NUMBER OF UNUSED RECORDS IN DATA 

PORTION OF FILE (PACKED). 

6 20-2019 2000 ONE BYTE REPRESENTS 2 TRACKS. THE TOP 

HALF OF THE TYPE (2 4 -2 6 ) REPRESENTS 
RECORDS 1 THRU 3 (RELATIVE) FOR THE ODD 
NUMBERED TRACKS. THE BOTTOM HALF OF 
THE BYTE (2 -2 ) REPRESENTS RECORDS 
1 THRU 3 (RELATIVE) FOR THE EVEN 
NUMBERED TRACKS. BITS 2 6 AND 2 1 
REPRESENT RECORD 4 FOR THE 70/590. 
A 1 BIT INDICATES RECORD IN USE, A 0 
BIT INDICATES RECORD NOT IN USE. 
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